package com.hongji.lms5xxcommunicator.grid.region;

import lombok.Value;

/**
 * <p>
 * 原始点口径的最高点，记录单点坐标及其可选标识。<br/>
 * 通常用于区域峰值的“即时点”比较。
 * </p>
 *
 * <p><b>职责</b></p>
 * <ul>
 *   <li>保存最高单点的坐标 (x,y,z)。</li>
 *   <li>可选保存该点的 {@code id}（例如数据库主键）。</li>
 *   <li>作为不可变值对象，保证构造后状态不可修改。</li>
 * </ul>
 *
 * <p><b>用法</b></p>
 * <ol>
 *   <li>通过 Lombok 自动生成的 getter 获取字段值。</li>
 *   <li>用于日志打印、峰值比较或前端展示。</li>
 * </ol>
 */
@Value
public class Point {
    /** 最高点的 X 坐标 */
    Double x;
    /** 最高点的 Y 坐标 */
    Double y;
    /** 最高点的 Z 坐标 */
    Double z;
    /** 可选：原始点 id（如数据库主键），可为 null */
    Long id;
}
